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INTRODUCTION 


Recent improvement in the productivity of current generation computer 
systems has directed attention not only to making the computer op- 
eration more efficient and self-regulating, but also to distributing 
the solutions more dynamically to problems within a given system. 

One of the most innovative approaches to the question of quick 
"turnaround" time has evolved as the Burroughs time sharing concept. 
Time sharing, or time slicing, is Burroughs technique for sharing 

the resources of the B 5500 computer system concurrently among an 
extensive number of simultaneous computer users. The objective of 
the time sharing system is to provide a response to every user within 


a given time interval. 


In the Burroughs B 5500 Time Sharing System, programs are successively 
rolled into memory from the rapid access head-per-track disk, are 
executed for a short time interval, and are then rolled out again. 
Each user of the system therefore receives a "slice" of computer 

time and, within a brief cycle of time, all programs receive a res- 


ponse trom the B 5500. 


The following advantages are gained from the Time Sharing System 
(TSS): 


a. The first and most important effect of the B 5500 TSS 
is improved personal effectiveness in problem solving. 
The individual user now has instantaneous access to the 
computer without inhibiting its ability to service other 


users at the same time. 


b. On-line programming and testing becomes a practical 
reality. The B 5500 TSS eliminates the traditional 
bottleneck to new application development, that is, 


computer access for testing and debugging. 


c. The full power of commonly based application programs 


is available to all users of the system thereby 


and file maintenance. 


Additional convenience and effectiveness are a by-product 
of locating the time sharing terminal right in the user's 
office. This, in essence, places the full power of a 

large-scale scientific and information processing system 


at the user's fingertips. 


The full advantage of powerful programming languages 


designed to service every user need: 


1) COBOL for servicing business and information 


processing. 


2) ALGOL and FORTRAN IV for servicing the needs of 
scientific and engineering applications in their 


most advanced state. 


a.) BASIC for developing an immediate system "usability" 
for people who have never used a computer before... 
easy-to-learn and a highly effective problem-solving 


tool. 


Allowing a user these dynamic system features is a set 

of generalized software, including compilers of the above 
mentioned languages, led by an operating system, a system 
commoniy known as the Master Control Program (MCP). The 
MCP maintains overall control of the system allowing the 
user to communicate with it through the Command and Edit 
language processor (CANDE) as described later in this 


manual. 


The time sharing operation can co-exist with normal, 
multiprocessing "production" jobs back at the central 
computer site. The B 5500 TSS eliminates the need for 


separate "special purpose" computers to service the 
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needs of information processing, scientific work, and 
conversational time-sharing. All of these functions 
are accomplished in a single advanced computer system, 
the Burroughs B 5500. 


The Burroughs B 5500 Time Sharing System incorporates, as realities, 


the most advanced state-of-the-art techniques in the industry. This 


manual is intended as a functional description of those technqiues 


and their application to the problem solving requirements of bus- 


iness, 
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education, science, and industry. 


SECTION 1 


GENERAL. 

The Burroughs B 5500 embodies a successful implementation of a 
spectrum of advanced design objectives. Burroughs approach to 
computer system design has been to totally integrate both hardware 
and software. The success of this approach was realized through 

a policy of cross-training the computer design teams. Hardware 
engineers were educated in the intricacies of software architecture 
and software designers learned the subtleties of hardware design. 
These people were then merged into a single design team. This 


merger resulted in a system which featured: 


a. Compiler Oriented Hardware. 
b. Multiprocessing Master Control Program. 
c. Dynamic Resource Allocation. 


dad. Automatic Program Segmentation. 


e. Homogeneous Hardware Organization. 


COMPILER ORIENTED HARDWARE. 

Traditionally, most competent systems programmers have rejected 
the use of high-level compiler languages because the ease and con- 
venience of their use demanded too great a sacrifice in compiling 


and operating efficiency. 


The Burroughs B 5500, by contrast, has proved to be a complete 
unity of high-level languages with efficient hardware operation. 
It is a computer that, for all practical purposes, evolved without 
a need for assembly languages. Its operating environment invoives 


the use of ALGOL, COBOL, FORTRAN, and BASIC. 


A technique called "Polish notation" was adopted as the basic archi- 
tecture for both the hardware and the software. Polish notation 
simplifies problem program expressions by eliminating the need for 
conventional rules of arithmetic precedence and “bracket grouping" 


of values within an expression. Using Polish notation, the 


expression: E:= (A+B) /C becomes: AB + C/ E:= 


The rule that applies is: follow two arithmetic values with the 
operation designated to work with those values. Thus every mathe- 
matical operator automatically works on the most recently obtained 


pair of operands. 


High level Polish notation is the "machine language" of the 
Burroughs B 5500 System. The approach which makes Polish nota-~ 
tion possible and powerful in its hardware implementation utilizes 
the Push Down Stack structure of these systems to allow programs 
to be considered as strings of elements which correspond to values, 


literals, and operators in the compiler languages. 


The Push Down Stack is the hardware implementation of the Polish 
string software design architecture. In hardware terms, it con- 
sists of two registers (at the top of the stack) and a contiguous 
area of memory that permits the stack to extend beyond the regis- 
ters. Working with a Polish string, the stack allows an arithmetic 
operator to work with whatever happens to be in the registers at 


a moment in time. 


This unity of software and hardware design results in dramatic 
efficiencies in program compilation and execution. The algorithm 
for program compiling is simply a matter of translating the source 
program into a Polish string object program, which is also a high- 
level language representation. The effect is to produce extremely 
fast one-pass compilations of high-level languages. In addition, 
the hardware is designed to efficiently execute the specific object 
program code produced. This removes the need for storing and re- 
trieving intermediate problem expressions, and allows straight-line 


non-redundant object execution. 


The full power of Polish notation and the Push Down Stack is brought 
to bear on problem solving in both the Time-Sharing and the multi- 


processing batch mode of operation on the Burroughs B 5500. The 


machine language of the system is compiler-oriented, thereby re- 
moving the need for wasteful anaiysis of the program source iangu- 
age, thus speeding compilations and producing highly efficient 


machine code. 


MULTIPROCESSING MASTER CONTROL PROGRAM. 

The prime criterion for successful implementation of a compre- 
hensive Master Control Program operating system is a clear iden- 
tification of the need for such a capability. Burroughs identified 
that need in the late 1950's. At that time the design objective 
was set to develop a computer system capable of controlling its 

own resources and scheduling work on a dynamic basis. In this 
manner, a number of programs should feasibly be concurrently 
executed in less time than if they were executed serially. More- 
over, at any moment in time more of the computer's physical re- 
sources should be in use by the multiplicity of programs than any 
single job could utilize. The result of this has been highly effi- 


cient utilization of the B 5500's problem solving facilities. 


The Master Control Program operating system has provided an advanced 
multiprogramming/multiprocessing capability for Burroughs users for 
a number of years. Since many of the features of the standard MCP 
have been chosen as the nucleus of time-sharing systems in the 
industry, Burroughs enjoys a significant advantage in its proven 
capability. These features have been subjected to the most rigorous 
field testing possible, and they have been producing practical 


results in customer installations for years. 


A Time Sharing System is perhaps the most sensitive to down time 

of all possible computer operating modes. When a system simulta- 
neously servicing a multiplicity of remote users suffers a condition 
causing the system to go out of operation, the whole user community 
suffers immediately and dramatically. Burroughs has a powerful 
answer to this need for continuous, uninterrupted remote service, 


dynamic resource allocation (fail soft or graceful degradation). 
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Dynamic resource allocation was originally developed as an integral 
part of the multiprocessing MCP. In past years, it has served 


two key functions: 


a. First, it has allowed new components to be added to the 
system with an immediate speed-up in throughput. As 
new devices are added to the B 5500, the Master Control 
Program immediately and automatically recognizes that 
it now has "more machine." More important, the MCP 
immediately begins using the new resources to process 
work faster than before. Further, this is accomplished 
without having to regenerate the operating system, re- 
write the programs, recompile the programs, or do any- 


thing except connect the components to the configurations. 


b. Second, it allows the B 5500 to continue producing 
results in the face of circumstances which might ordi- 
narily prove disastrous to other systems. Much as it 
senses and reacts to additions to the system resources, 
it also recognizes deletions from the system and reacts 
by re-routing the work around the trouble spot. A memory 
module, an I/O channel, a peripheral device, or even a 
central processor (in a two processor system) can be taken 
off-line and the rest of the system can be made to continue 


producing results. 


The Master Control Program continually checks the status of the 
total system, and it automatically fits object programs to those 
system components that are available at any moment in time. Com- 
prehensive but compact “availability tables" keep the MCP informed 
of the number of tapes, disks, printers, 1/0 channels, and other 
devices that are available and ready; and changes in the status 

of the system are easily detected because of advanced hardware/ 


software integration. 
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As soon as the MCP has the status information, it can allocate 


The moment a Burroughs user 


t 
the system's resources accordin ent a Bu egehs u 
plugs in a new memory increment, or another 1/0 channel, or even 
an additional central processor, the program that originally re- 
quired 10 minutes may now take as little as 3 or 4 minutes to 
run to completion. More important, when a component is taken 
off-line for any reason, the system continues to function. The 
B 5500 continues responding with problem solutions to the whole 


network of remote users. 


The B 5500 Time Sharing System effectively alleviates the most sen- 
sitive criticism of time sharing: accessibility and guaranteed 


response on a continuous stream of problem-solving demands. 


AUTOMATIC PROGRAM SEGMENTATION “PAGING, " 


The computer industry has set as its objective, freeing the problem 
programmer as much as possible from the physical limitations of 
computer hardware. This objective has taken many forms and suffered 
various degrees of success and failure, particularly when the 
question of "practicality" is raised in connection with a parti- 
cular feature and/or computer system. Burroughs B 5500 Time 

Sharing System addresses virtually all of the facilities required 

to satisfy the "hardware independence" objective, and provides 
practical and workable answers. A number of these facilities have 


been explored above. 


Automatic Program Segmentation is one of the most powerful of 
Burroughs' third generation "realities." It provides a creative 


solution to two questions: 


a. How can a multiprocessing computer system efficiently 


use its memory all of the time? 


b. How can the computer handle programs that exceed its 


physical memory capacity? 
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Burroughs B 5500 Time Sharing System provides "virtual memory" 
for unlimited program size. Automatic Segmentation has, in fact, 
been a working reality on the standard B 5500 MCP for years, and 
it has been a practical reality. This capability is based on the 
use of compilers as program pre-processors. These Burroughs com- 
pilers logically segment all programs at compilation time and 


create a detailed record of how the segmenting was performed. 


The effect of Automatic Program segmentation is to allow the pro- 
grammer complete freedom from the physical limitations of hardware 


memory in developing application solutions. 


HARDWARE ORGANTZATION. 

The hardware architecture which makes multiprocessing and dynamic 
resource allocation practical is centered around two exchanges ... 
the memory exchange and the input/output exchange. These central 
controls operate as small integrated computers charged with res- 
ponsibility for allocating the total resources of the system to 


job processing. 


Each processor (on a dual processor system) accesses memory through 
the exchange. Likewise, the maximum of four input/output channels 
can access memory without interfering with the processors. The 
channels in turn, can access any of the peripheral devices through 


the input/output exchange. 


CHANNEL 1 
CHANNEL 2 


CHANNEL 3 |. 


MEMORY 


Figure 1-1. Hardware Organization 
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The exchanges contain the logic and registers to "float" the demand 
for accesses to whichever channel path happens to be free to handle 
it. With these floating channels and memory paths, both processors 
and all four channels can be executing memory accesses simultane- 
ously. Therefore, under control of the Master Control Program 
operating system, the data paths and configuration of the system 
are continuously optimized to answer the demands of the moment. 
This is accomplished automatically, without programmer awareness 


or concern. 
A maximum configuration of the Burroughs B 5500 allows for: 


a. Two central processing units. 


b. Eight independent memory moduies (each 4,096 words). 


c. Four floating input/output channels. 

d. Sixteen magnetic tape drives. 

e. Two billion characters of on-line disk storage. 
f. Two line printers. 

g. Two card readers. 

hy “Gwe paper tape readers: 


i. One card punch. 
Ace One paper tape punch. 
k. One supervisory console. 


1. 240 communications line buffers. 


The B 5500 Data Communications Network can expand dynamically to 
meet growing time sharing requirements. And the expansion or con- 
traction of the system is accomplished without reprogramming or 
recompiling. The Time Sharing Master Control Program balances 

the current total program mix against the available system confi- 
guration, for the most efficient operation under continuously 


changing conditions. 
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SECTION 2 


GENERAL. 
The software systems of the Burroughs B 5500 Time Sharing System 
consists of the Master Control Program, the Command and Edit lan- 


guage processor, and the programming languages. 


THE MASTER CONTROL PROGRAM (MCP). 


The primary purpose of the MCP is the efficient distribution of 
system resources among the users. It is capable of controlling 

its own resources as well as scheduling work on a dynamic basis. 

In this manner, a number of programs should feasibly be executed 
concurrently in less time than if they were executed serially. 
Moreover, at any moment in time, more of the computer's physical 
resources should be in use by the multiplicity of programs than 

any single job would normally utilize. The result of this has 
proven highly efficient utilization of the B 5500's problem solving 


facilities. 


Memory in the B 5500 TSS is divided into two distinct areas by a 
"fence" or pre-determined boundary. The MCP and the Command and 
Edit language processor are run on one side of the fence. Jobs 
which are initiated by remote users are run on the other side of 
the fence and are swapped in and out of core; i.e., they are tem- 
porarily suspended and rolled out of core to disk to make room for 
other remote jobs. There are five main conditions which cause 


remote programs to be rolled out: 


a. The program is input limited, that is, it is waiting for 
data which has not yet been entered from the remote unit. 
While the user transmits additional data needed to con- 
tinue processing, the program resides on disk and makes 


its memory resources available to other users. 


b. The program is output limited, that is, it has generated 


enough data to fill the disk buffer area assigned to it. 
Therefore, the program turns its resources back to the 
system while the current data is transmitted to the user. 
The next time it receives its share of computer time, it 
can again generate additional data for transmission to 


the remote terminal. 


c. The program has used the slice of time allocated to it 


without encountering an input or output limited condition. 
d. The program has reached completion. 


e. The program is forced out to make room for an entering or 


re-entering job. 


When a job first enters the mix, it is assigned to an area in core 
which minimizes conflict with other active jobs and is then given 
an immediate time slice. If necessary, jobs in core are rolled out 
to make room for it, unless they too are getting their first time 
slice. in that case, the new job is piaced at the head of the 


queue of jobs waiting for a time slice. 
Some of the other important features of the MCP are: 


a. Priority scheduling lets the individual user program 
govern its relationship and importance to other jobs 
being concurrently executed in the system. With multi- 
level priorities, each job's importance is recognized by 
the system and is given attention based on its ranking at 
the moment. In addition, job priorities can be changed 
dynamically, while processing, to answer more urgent 


demands on the system. 


b. Automatic file recognition allows ail program and data 
files to be addressed by name rather than by physical 


input/output unit. In this manner, jobs can be allowed to 


use any device that happens to be available at the moment. 


This greatiy facilitates the initiation and execution of 
jobs in a community of remote users and, at the same time, 
permits practical multiprocessing to be accomplished on 


regular production jobs. 


True device independence allows magnetic tape and disk to 
be used as backup or "pseudo" devices for card readers, 
punches, and printers. This means that jobs are not 
delayed waiting for access to a busy peripheral unit. 
Instead, such jobs automatically (or at operator option) 
stream out to a backup device. It also means that tradi- 
tional "satellite computer" operations such as card-to- 
tape, card-to-disk, tape-to-print, and the like, are now 


accommodated on a single computer system. 


Comprehensive logging is a standard by-product of MCP 
processing. The log can provide a breakdown of time as 


foliows: 
1) By job - the time used for processing and input/output. 


2) By job - the time used by each physical device to 
execute the job. This includes the processor, card 
readers and punches, printers, magnetic tapes, and 


magnetic disks. 


3) By device - the amount of time each physical unit 
was used by the system ... and a summary of errors 


incurred by each unit. 


4) By type of job - the amount of time and number of 
times the system was used for compilations (for each 


compiler), executions, and runs. 


5) By job mix - the amount of time the system was run 


with a given number of jobs currently in the mix. 


The accounting facilities of the Time Sharing System will then 
generally ensure that all time and disk’ space used by the remote 
users is accounted for. The time includes that involved for library 
maintenance, file editing, line usage and command language pro- 


cessing, as well as that related to the running of programs. 


THE COMMAND AND EDIT LANGUAGE PROCESSOR. 

Running with the MCP in an area of resident memory is the Command 
and Edit (CANDE) language processor. CANDE serves as the interface 
between the remote user and the MCP. The user communicates with 
the system using established Command and Edit verbs by which he 

can attach himself to the system, create and manipulate files, and 
compile and run desired programs which he either wrote or updated 


from his remote unit. 


PROGRAMMING LANGUAGES. 
Users of the B 5500 TSS have full language compatability of the 


following: 


a. B 5500 Time Sharing ALGOL provides a fail-safe version 
of B 5500 Extended ALGOL, including string manipulation 


capabilities. 


b. FORTRAN IV implemented to the specifications of FORTRAN 


IV, version 13. 


c. B 5500 COBOL implemented to the specifications of D.0O.D 


COBOL 61, with extensions. 


d. BASIC? since it is widely accepted in the industry as a 
language which is easily understood and can be used by 
people without computer experience. In addition to serving 
as a learning tool for the computer layman, it can be 


readily applied to many business and scientific problems. 


1. Developed at Dartmouth College 
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Programs written in these languages are automatically segmented on 
the logical boundaries of the language; e.g., ALGOL programs being 
segmented according to blocks, COBOL programs according to para- 
graphs, and FORTRAN programs according to subroutines. These 
segments allow a program of virtually unlimited size to be exe- 


cuted within a relatively small amount of memory. 
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GENERAL. 

Input to the system consists of messages typed in at the remote 
terminal. Each message must be ended with a left arrow (+). After 
a left arrow has been typed, the system responds with a carriage 
return and a line feed to automatically position the teletype for 
the next line of input. Any carriage returns and line feeds typed 
by the user are ignored by the system. The system will not accept 
messages which are more than 72 characters in length (45645 one 


Teletype line). 


USER IDENTIFICATION. 


Before the user can utilize the system capabilities, he must first 
present his user code and password to the system. The password 
gets typed into an area that the Teletype has blacked out to ensure 
that only authorized persons gain access to the system. CANDE 

will check the user's identification against its file of authorized 
users. If the code entered is not in the file, the user will be 

so informed by CANDE and he will be prevented from using the system 
until a correct log-in procedure is entered. If the code is in 

the list of authorized users, CANDE will log the station in, record 
its current log-in time, and consider the station to be a bona fide 
user. (See LOG-IN for a further description of thas procedure. ) 
After a successful log-in, the user code is used to identify the 


accounting information for the session as well as any files created. 


In addition, the user has the option of also entering a charge 
code which is added to the accounting information but is not used 
as verification by the system. This can be used to further assist 


internal billing and accounting. 


COMMANDS. 

Each command in the Command and Edit language consists of a verb 
and, in most cases, a list of parameters. The parameters in the 
list are separated from the verb and from each other by commas 

or blanks. In the examples contained herein, commas will be used, 


but they are not required. 


When CANDE has finished processing a command, it will type a 
message either confirming successful completion of the command or 
indicating an error. Errors terminate the processing of a command 
and the entire line must be retyped correctly. After certain verbs, 
a number sign (#) is used to indicate completion. The user should 
not type anything between the time he types the command and the 
time the response from CANDE is typed. 


It should be noted that more than one command may be included on a 
Single line if the commands are separated by semicolons. However, 
if an error is contained in a command, any further commands on 


that line are ignored. 


ERROR MESSAGES. 

Error messages consist of the word ERR followed by a colon and 
usually a one word error description, such as ERR:NOFILE. The user 
can request further information about the error by typing a ques- 
tion mark followed by a left arrow. The error messages that may 
result from improper use of a given verb are discussed in the 


section containing the description of that verb. 


LOG-IN. 
Before he is allowed to use the system, the user must make contact 
with the computer and submit proper identification. To establish 


a connection, the following steps should be taken: 


a. To turn the Teletype on and obtain a dial tone, push the 
ORIG (originate) button. 


b. Dial the computing center. When the computer ac 


thn q 
CE call, ZL 


and the system types: 
B5500 TIME SHARING 


If the phone keeps ringing, the system is temporarily unavailabie. 
If a busy signal is heard, the system is loaded to capacity. Tn 


either case, re-dialing is necessary. 


After a connection is made, the system initiates the log-in 


sequence which consists of the following steps: 


a. The system types 
ENTER USER CODE, PLEASE- 


and the user complies by entering the user code assigned 


to him. 
b. The system then responds with 
AND YOUR PASSWORD 


and blacks out seven spaces on the next line into which 


the user must enter his password. 


c. if the system recognizes the user code and password, it 
proceeds to step d. If it does not recognize them, it 
types 

BADCODE 


ENTER USER CODE, PLEASE- 


and the log-in procedure begins again. If the user does 
not enter his user code within 30 seconds or if he fails 


to log-in correctly on his second try, he is disconnected. 


If it has been specified that a charge code be requested, 


the system types 
ENTER CHARGE CODE, PLEASE- 
and the user enters the charge code for the session. 


Whether or not a charge code is requested, the system 


signals its readiness to accept a command by typing 
YOU HAVE LINE logical line number, user name 


mm/dd/yy, time 


The logical line number is the systems recognition of 


the line dedicated to the user. 


Example: 


FILES. 
A file 


unit. 
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B5500 TIME SHARING 


ENTER USER CODE, PLEASE-usercode~ 


AND YOUR PASSWORD 


NNKKKNN (user enters password 
in blacked out area) 


ENTER CHARGE CODE, PLEASE-charge 


YOU HAVE LINE 07, user name 


07/23/68 6:20 PM 


is any collection of information which the user regards as 


it is the primary means by which he establishes continuity 


between one session at the Teletype and the next, the "session" 
being that sequence of activities mutual to the system and the 


user between one log-in and the next log-out. 


FILE NAMES. 

Each file in the system has a unique identification consisting of 
a file name and a user code. When a file is created, the user 
supplies the file name and CANDE adds his user code to forma 
complete file identifier. File names may be from one to six 
characters long. The first character must be a letter and any 
remaining characters must be a combination of letters and digits. 
If more than six characters are used, the right-most characters 


are truncated. 


Examples: 
x 
FILEL 
JONES 
D23xvY8 


FILE TYPES. 

Associated with every remote file is a file type. The file types 
are:. ALGOL, COBOL, BASIC, FORTRAN, and SEQ (sequenced). The 

first four types specify that the file contains a program written 
in that language. A sequenced file may contain any kind of data 
including source code of given programs or parts of programs. Data 
files also may contain any kind of data but, unlike the other five 


types, they do not contain sequence numbers. 


SEQUENCE NUMBERS. 

All files which are edited by CANDE must contain sequence numbers. 
A sequence number is defined as a positive integer containing a 
maximum of eight digits which must appear as the first item on a 
teletype line. It is used to identify the line for editing and to 


specify the lines position in the file. Even if the lines are 


2=5 


typed out of order, CANDE will arrange them in ascending numerical 
sequence. Except for programs written in BASIC, the sequence num- 


bers are not considered to be a part of the data in a file. 


WORK FILE. 

The Command and Edit language allows the user to create or modify 
the contents of only one file at a time. That file is referred to 
as the work file. Changes and additions made to the work file do 
not become permanent unless the user issues a SAVE command. In 
this way, a file can be created, used, and then discarded if it is 
no longer needed. Similarly, an existing file can be modified 

and used without affecting the original copy of the file. If a 
SAVE command for the modified version is not issued, the original 
version remains on disk and can be used again. The original file 


is only changed permanently when a SAVE is typed. 


Changes are kept in the work file until either another file is 
specified as the work file or the users session is terminated. The 
work file, therefore, can be used like any other file; that is, it 
may be further changed, listed, compiled, or run. For example, a 
source file could be loaded and modified, and then compiled and 
tested until it was completely debugged before it was finally 
saved, thus ensuring that the running version of the program was 


available at all times. 


USER LIBRARY. 

The set of files that a user creates and saves are referred to as his 
user library. Each file in the library must have a different name. 
If an attempt is made to create a new file with a name that is 
currently being used, the system will notify the user via an error 


message. The necessary change or remove options must be exercised. 


ACCESSING OTHER USER'S FILES. 
A user may not access files in another user's library unless the 


owner of the library has authorized him to do so. To do this, the 
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owner uses the GUARD command to create a GUARD file which is a 


specially formatted 


alana food 
bel nging 


£20 a 


other users. 


file containing user codes and program names 


the GUARD file with 


He then 
Gite 


associates 


specific files in his library through the GUARD and LOCK commands. 


These files, called 


and programs listed 


private files, 


on the GUARD file. 


can then be accessed by the users 


Those files which do not 


have associated GUARD files are called sole user files and can be 


accessed only by the user who created them. 


In addition, files may 


be made available to all users with the UNLOCK command. 


Once he has been authorized to do so, 


a user accesses a file in 


another user's library by using the file name followed by either a 
slash (/); or the word LIBRARY, and then by the user code of the 


owner of the file. 


another user's file; 


maintenance. 
The file 


ENTERING DATA. 


ha 
Woe 
tape. Data entered 
Once a work file is 


number are added to 


It should be noted that a user can only read 


he cannot write on them or perform library 


security system is further described in appendix C. 


Gin the remove: und 
by hand (keyboard) must include sequence numbers. 
specified, all lines beginning with a sequence 


the work file. 


Errors in the work file may be corrected by using the FIX command or 


by retyping the line in error using the same sequence number. 
new line will overwrite the old. 


part. of the work file, 


must be typed. 


Example: 


The 
To delete a line which is already 


the sequence number and then a left arrow 


MAKE SAMPLE BASIC < 


FILE:SAMPLE TYPE:BASIC -- 


CREATED 


"THIS IS AN EXAMPLE OF A BASIC PROGRAM < 
100 X=5 < 


150 Y=7— 
200 B=X+Y- 

250 PRIMT X,Y,Am 

175 AsX+Yo 

300 END< 

"LIST WILL CAUSE THE SYSTEM TO SORT THE WORK FILE“ 
"AND TYPE IT OUT.< 

LIST+ 


FILE:SAMPLE/- TYPE:BASIC --05/25/68 6:46 PM. 
100 X=5 

150 Y=7 

175 A=X+¥ 

200 B=X+¥ 

250 PRIMT X,¥,A 

300 END 


END LIST 1.0 SEC. 

"SINCE LINE 200 IS NOT USED, TT CAN BE ELIMINATED 
200- 

"CORRECT MISSPELLING AT LINE 250- 

250 PRINT X,Y, Au 

"NOW WHAT DO WE HAVE" 

LIST 


FILE:SAMPLE - TYPE:BASTIC --~05/25/68 6:48 PM. 


END LIST 1.0 SBC, 
"LOOKS OK NOW 


PAPER TAPE INPUT. 
Most teletypes have an attached paper tape reader which can be used 
t 


s 
to en ut as an alternative to the keyboard. Thus, programs 


ser inp 
and data may be created and stored off-line and then entered at 
relatively high speed when the terminal is connected to the B 5500 
Time Sharing System. The paper tape must be in the proper format 


for the system. 


After the paper tape punch is turned on, 10 or 20 rub-outs should be 
typed to provide a leader for mounting the tape in the reader. Since 
reading the tape causes the teletype to print, each line punched into 
the tape must end with a left arrow (<), a carriage return, a line- 
feed, and one or two rub-outs. (The rub-outs, which are ignored by 
the system, make it easier to visually locate a particular record 

on the tape.) It should be noted that an X-OFF character is not 
needed. After all lines have been punched, 10 or 20 more rub-outs 
should be typed to provide a space in which the reader may be turned 


off. 


Since the records from paper tape are read directly into the work 
file, system commands (with the exception of the FIX command) may 
not be punched in the tape. For further information, see the des- 


cription of the TAPE command. 


SPECIAL CHARACTERS. 

he characters on the remote unit which are not letters or digits 
are called special characters. The special characters which can 
be used with the B 5500 Time Sharing System are listed in appendix 


A. Use of the other special characters will result in errors. 


The left arrow (<), the backspace ('), and the delete (!) are always 
recognized by the system to function as described. Alli other valid 
special characters may be used in data, comments, and certain commands 


but are illegal elsewhere except for the following uses: 


CHARACTER 
' Backspaces one character. 


! Deletes the current line. 


ee 


= Marks the end of an input message. 


: Separates commands within an input message. 


or Separate parameters within a command. 

’ 

# Indicates successful completion of a command. 
? Requests additional information from CANDE. 


" Introduces a comment. 
+ Specifies increment for the SEQ verb. 


- Used in lists of sequence numbers. 


BACKSPACING. 

The apostrophe (t) is used as a backspace to delete the most recently 
typed character. Repeated use of the backspace will delete a corre- 
sponding number of characters, but only to the start of the current 


line. Thus, 
MAKE. XYZ'2 


Would appear 


and 
MAKE!!! 'LTst 
would appear to CANDE as 
LIST 


DELETING A LINE. 

An entire line can be deleted by typing an exclamation point (i). 
After a delete is typed, the system types DEL and positions the print 
head at the start of the next line so that the user can continue his 


input. The delete cannot be used repeatedly, thus only the current 
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Examples 


X=SQRT(X**24Z!DEL 
100 X=SQRT(Y**24+Z**2) <= 


COMMENTS. 

Lines which begin with quotation marks (") are treated as comments, 
the contents of which have no effect on the use or operation of 
the file being created. When the user has finished a comment, he 


can continue to type in data, commands, or further comments. 


Examples: 


"THIS IS A COMMENT? < 
"IT BEGINS WITH A " AND IS COMPLETELY IGNORED < 


RUNNING A PROGRAM. 
Two following steps are invoived in running a program from a source 


file. 


a. Compilation. The source file is translated into machine 


b. Execution. The machine instructions in the object file are 


executed, 


The Command and Edit language allows the user to specify either 
compilation or execution with the COMPILE and EXECUTE verbs, or 
using the RUN command, to request that CANDE do whatever is necessary 


to execute the program. 


All three of these verbs allow the user to specify a particular file 
or, by default, to specify the work file. If the command specifies 
a file which was loaded to form the work file, the version of the 
file on disk is used, not the work file. For instance, if the 


following had been done: 


LOAD TEST ~ 
FILE: TEST - TYPE:BASIC -- LOADING 


END LOAD 1.1 SEC. 
100 X=Y**2 


then the command 
RUN TEST 


would cause the old version of TEST without the change at line 100 


to be run, whereas 
RUN 


would cause the work file version of TEST to be run, which includes 


the change. 


If an error occurs during a compilation or execution, CANDE prints 
an error message and identifies the sequence number of the line 


which caused the error. 


Anything not beginning with a question mark which is entered after 
a RUN or EXECUTE command and before the completion of an execution 
is assumed to be data for the program and is put in a special file. 
When the program requests data from the teletype, it will use any 

data that has already been entered before requesting further input 


from the teletype. 


During a run, ?STATUS may be used to ask for information about the 
program. It is not considered to be data (see the STATUS command). 


Anything else following a question mark is ignored. 


has started running, he should type a WRU (control E) or a BREAK, 
depending on whether or not the teletype is typing under system 
control. If it is typing, the BREAK is used. If it is not, WRU 


-USER DS-ED, LINE NO sequence number 
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and then a number sign (#) when it is ready for further input. 


Compilations can be terminated by a BREAK or WRU like any other 
program. BREAK can also be used to suppress the output from a LIST 
command. However, the programs run by CANDE to process such commands 
as LIST, PRINT, APPEND, MERGE, COPY, DELETE, and RESEQ are not 
terminated by a BREAK or WRU. 


In the rare event that something does go wrong with the system, a 
HALT/LOAD is performed. This causes all processing on the system 
to be halted and the system to be reinitialized. Data can be lost 
from the work fiie and any user programs which were running must be 


restarted. 
After a HALT/LOAD, the system types 


P 
L 
O 
P 
RESTARTING . . . PLEASE WAIT 


and then asks the user for his user code and password to log him back 
on the system. If the user had data in the work file, CANDE wiil 
usually be able to recover it. However, the last few records should 


be listed to ensure that nothing was lost. 
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SECTION 4 


RING COMMANDS 


oat as 


GENERAL. 

The commands available with the Burroughs B 5500 Time Sharing System 
are described in this section. These commands give the computer 
system direction as to specific actions which must be executed in 
order to perform the required tasks. The commands are presented 

in alphabetical order to make access to them more convenient to the 


user. 


TYPOGRAPHIC CONVENTIONS. 
The following conventions have been used throughout this manual to 


describe the syntax of the Command and Edit verbs: 


a. Upper case letters and special characters in a given 
format denote the literal occurrence of the characters 


represented. For example, 


MAKE f 


denotes the literal occurrence of the verb MAKE foliowed 


by a file name. 


b. Lower case letters denote variable elements of a command. 
For instance, f£ in the above example indicates that the 
verb MAKE must be followed by the name of a file. Thus 


the above construct could be written as 
MAKE UTIL2 
where UTIL2 is an acceptable fiie name. 


c. Ellypsis marks, ..., denote the occurrence of the imme- 
diately preceding syntactical item one or more times. 


For example, 


SCHEDULE f,,f5,.--f, 


indicates that the verb SCHEDULE must be followed by a 


file name which in turn may or may not be followed by 


one or more file names to form a longer list. 


Tt also should be noted that, in the examples to follow, characters 
typed by the system are underlined. Those characters not underlined 


are understood to have been typed by the user. 


NOTE 
The complete Command and Edit syntax 
is also provided in COBOL format in 


appendix D. 


APPEND 


APPEND. 
Records from a given file may be copied onto the end of the existing 


work file with the APPEND (or ADD) command. The format is as foliows: 


1. APPEND £ 


APPEND f,q 


where f is a file name and q is 
a list of one or more elements, 
in any combination, of the fol- 
lowing two forms: 


where s, s,, and 
Ss, are sequence 
numbers and S5 

> S_. 

1 


In addition, the last element of 
the list q may be one of the fol- 
| lowing two forms: | 
a. END 
b. s TO END 


where s is a se- 
quence number. 


If no sequence numbers are specified, the entire file is appended. 
Otherwise, only the specified portions are added. The appended 
lines are given sequence numbers equal to their old sequence num- 
bers, plus the highest sequence number originally in the work file. 
If this results in a sequence number of more than eight digits, the 


error message 


ERR : TOOBIG 


APPEND 


continued 


is typed, and the remaining lines are not appended. 


Example: 
LIST TA 
FILE:TA - TYPE:SEQ -- 6/28/68 #220 0PM 
10 TEN. 
20 TWENTY. 


END LIST .9 SEC. 


MAKE T1- 

FILE:T1 - TYPE:SEQ -- CREATED 
100 ONE.<« 

200 TWO. 


300 THREE.< 
APPEND TA; LIST— 


Fis 


FILE:T1l - TYPE:SEQ --6/15/68 7:22 PM 
ONE. 


THREE. 
TEN. 
TWENTY. 


wo IF [Oo 1O Jo 
Oto 19 10 oO 


END LIST 1.0 SEC, 


yoy 


BYE 


BYE. 


The BYE verb terminates a user's session. The format is: 


After the user types BYE, the system responds with 


ON FOR n, SEC. 


C&E USE n, SEC. 


MIN, Ny 
OFF AT time 
GOODBYE usercode 


and then performs a disconnect. The user may also log-out by 
pressing the CLR (clear) button or by typing an End-of-Transmission 
character (control D). In either of these cases, the system re- 


sponse cannot be given. 


Example: 


BYE 
ON FOR 27 MIN, 19.3 SEC. 
GOODBYE HARRY 
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CHANGE 


CHANGE. 
The remote user can change his password or various file parameters 


using the CHANGE command. The format of the CHANGE command is: 


‘lL. CHANGE PASSWORD 


2. CHANGE fy TO f, 


3. CHANGE f TYPE TO ¢t 
5. CHANGE TYPE TO t 


where f, fy and f, are file names, t is a 


and s is a security file name. 


file type, 


The CHANGE command can be used to change the user's password. The 

system will ask the user for his old password, his choice for a new 
password, and a verification (re-entry) of his new password. If an 
error is made in entering the old password or verifying the new one, 


the system types 
ERR: BADCODE 


and the change procedure must be started again. Successful comple- 


tion of the change procedure is signaled by a number sign (a). 


Example: 


CHANGE PASSWORD < 
ENTER OLD PASSWORD, PLEASE 


NNNNHWH (old password entered) 
NEXT ENTER NEW PASSWORD 

XXXXXXX (new password entered) 
PLEASE REPEAT YOUR NEW PASSWORD, FOR VERIFICATION 
NRRNNAWH (new password entered) 


if 


The CHANGE command can also be used to change the name or the type o 


f 
+ 
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either a library of file or the work file. 


CHANGE 


| continued | 


The use of TO or TYPE TO causes the name or the type of the specified 


file to be changed to the file name or file type given in the com- 


mand. If an attempt is made to change a file name to a name that 


is already in use, the error message is: 


If a file name does not appear immediately after the verb, 


applies to the work file. 


ERR:file name 


number sign (#). 


Example: 


LIST FILES< 


FILE: STUFF TYPE:SEQ 
FILE: UTIL TYPE: FORTRAN 


2/1 /oi 
03/21/68 


#CHANGE STUFF TYPE TO COBOL= 


#CHANGE STUFF TO UTIL= 
BRR:U 


TL 
CHANGE UTIL TO UTIL2< 
#CHANGE STUFF TO UTILI<- 
#LIST FILES< 

PILE:UTIL1 TYPE:COBOL 


FILE: UTIL2 TYPE: FORTRAN 


if 


12/17/67 
03/21/68 


the change 


A successful change is indicated by a 


hn? 


CHARGE 


CHARGE. 


The CHARGE command changes the charge code during a user's session. 


CHARGE c 


where c is the charge 
code of up to seven 
alphanumeric characters. 


Its format is: 


Proper information is entered in the log to reflect a change of 


charge code. 


Example: 


COMPILE. 


COMPILE 


To compile a source program and create an object file, the user 


issues a COMPILE command. The format is: 


where f is the file name 


COMPILE f,c 


and c is the compiler name. 


If a file name is not given, the work file is compiled; otherwise, 


the specified file is compiled and the resultant object file is 


saved. If the work file is compiled, the object file is kept with 


the work file so that both source and object versions can be saved 


with a SAVE command. Tt should be noted that a SAVE command is 


ignored if data has not been entered into the work file since it was 


created or last saved. Thus; 


LOAD X;COMPILE; SAVE“ 


is not necessary to save the object version of 


COMPILE X= 


which will automatically cause the object file 


The compiler name may be ALGOL, COBOL, FORTRAN 


abbreviation consisting of a colon followed by 


X. The command which 


to be saved. 


or BASIC, or an 
the first letter of 


the compiler name. It is required when files of type SEQ or type 


DATA are compiled but can be used for any type 
the original file type. 


Tf the work file is not declared when needed, 


ERR: WRKFILE 


file and will override 


the error message is: 


If a source version of the file named is not in the library, the 


error message is: 


ERR: NOFILE 


COMPILE 


continued 


When the file is found, CANDE types 


and, when the compilation is finished, 
END COMPILE n SEC. 


is typed indicating the amount of processor time used during the 


compilation. 


Example: 


COMPILE TESTO2< 
COMPILING 

200 Y:UNDEFINED 

END COMPILE 1 SEC. 
#LIST TESTO2 200< 
FILE: TESTO2 - TYPE:ALGOL ~-05/22/68 
200 X:=X/Y; 

END LIST 1.0 SEC. 
LOAD TESTO2< 
FILE:TESTO2 LOADED 
200 X:sX*X3- 
COMPILE= 

COMPILING 

END COMPILE 1 SEC. 
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COPY 


COPY. 
The COPY command is used to copy a file onto the work file or onto 


a peripheral unit. The format of the COPY conimand is: 


where f is 


a. afile name 
b. file name /user code 
Cc. file name LIBRARY user code 


h is the hardware type, and 


b. 3 - designates punch 
c. 4 - designates tape 


q is a list of one or more elements, in 
any combination, of the following forms: 


ae END 


be. s TO.END 


where s is a sequence number. 


ris 


H 
a. 2 - designates printer 


a. RESEQ 

b. RESEQ S1 - S85 

om RESEQ base 

d. RESEQ S$, 7 85 + increment 
e. RESEQ base + increment 


RESEQ 1 TO So 


RESEQ Sy TO So + increment 


where S, may be the word END. A list of 
the abo¥Ve would require 64 cases. 
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COPY 


continued 


When a COPY TO hardware command is entered by a user, a copy of 

the file is placed on disk and identified by placing either a 2, 

3, or 4 (for files to be printed, punched, or placed on tape) in 
front of the file names. Only alphanumeric files can be printed 

or punched. Files copied to tape are placed on multi-file tapes, 
identified as user code/file name, and are blocked (56, 10). These 
are processed by the program HARD/CANDE, which is initiated by the 
installation operator. The output will be sent to the user from 
the computing center. After the system schedules the output, 

CANDE responds with a number sign. If there are files to copy, 


the program asks: 
FILE NAMES? 


and the operator enters either a YES or NO via an AX message, de- 
pending on whether or not he wishes a list of names of all files 


waiting to be copied. The program will then ask: 
WHATS NEXT? 
and the acceptable responses are: 


a. ALL. 

b. STOP. 

c. Hardware type. 

d. User code. 

e. File name/ user code. 

f. Hardware type user code, 


g. Hardware type file name/user code. 

The corresponding actions taken by the program are: 
a. COPY all files. 
b. Terminate. 


c. COPY all files designated for the specified unit. 
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COPY 


continued 


e. COPY the designated file (may be to more than 


one unit). 


f. COPY all files belonging to the user which are 


designated for the specific unit. 
g. COPY the file. 


The acceptable entries for hardware types are PRINTER, PUNCH, or 
TAPE. 


When files are copied to tape, they are blocked (56, 10). All the 
files for a given user are placed on one tape using the user code 
as the multi-file identification and the file name as the file 
identification. Thus, a file identified on disk as file name/user 
code will appear on tape as user code/file name. When a file is 
punched, it is preceded by a blank card, a card identifying the 


file, and another blank card. 


After a file is copied, the copy on disk is removed. The program 


4 ~~ oO a +A sacl 
iil continue to ask 


files are copied. 
After the copy has been performed, CANDE will type: 
END COPY. 


Within the rules of file security, the COPY command may be used to 
access files in another user's library by inctuding his user code 
after the file name. If the user issuing the COPY command has not 
been authorized by the other user to access his files, the COPY 


will not be performed and CANDE will type: 
ERR:user code 

If the file is not in the library, CANDE types: 
ERR:file name 


If there is no work file, the error message is: 
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COPY 


continued 


Examples: 
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ERR: WRKFILE 


LIST EXAMP— 

FILE: EXAMP - TYPE:SEQ -- 06/06/68 
100 THIS 

200 HERE 

300 Is 

400 AN EXAMPLE 

END LIST 1.0 SEC. 

MAKE GOOD; COPY EXAMP 100, 300-END— 


FILE:GOOD - TYPE:SEQ -- CREATED 
WAIT. 

END COPY .n SEC. 

LIST — 


FILE:GOOD - TYPE:SEQ --07/24/68 
100 THIS 

300 Is 

400 AN EXAMPLE 

END LIST .9 SEC. 


CREATE 


file. The formats of the CREATE command are: 


1. CREATE f 


where f is a file name, t is a file 


type, and n is the number of lines 


to be contained in the file. 
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DELETE 


DELETE. 
The DELETE verb is used to delete all or part of the current con- 


tents of a work file. The format is: 


1. DELETE ALL 
2. DELETE q 


where q is a list of one or more 
elements, in any combination, of 
the following two forms: 


ae s 


b. “S5 


where s, Si; and 


sequence numbers 


So > 2° 


In addition, the last element of 
the list q may be one of the 
following two forms: 


a. END 
b. s TO END 


where s is a sequence 
number. 


If there are no parameters following the DELETE verb, the ALL 
option is assumed. The parameter ALL causes the contents of the 
work file to be removed, but does not affect the file name asso- 


ciated with the work file. 


If sequence number parameters are used, an entry of the form s 
causes the line with that sequence number to be deleted. An 
of the form S,-S, causes the deletion of all lines from the first 
through the second sequence number, inclusively. The use of the 

word END is equivalent to using the highest sequence number in the 
file. Thus, if the last entry is END, the last line in the file 

will be deleted and, if the last entry has the form s TO END, all 


lines with a sequence number greater than or equal to the sequence 


4-16 


DELETE 


continued 


number will be deleted. The sequence numbers must be arranged in 
ascending numerical order. If one is out of order, it is flagged as 


an error by the message: 
ERR: SEQNUM 


A maximum of nine sequence numbers are allowed in a given list. A 
request to delete non-existant records according to sequence number 


reference is ignored. 


After the specifield lines have been deleted, CANDE wiil type END 
DELETE. 


Example: 


MAKE TRASH 


100 EXAMPLE OF< 
200 DELETE VERBE< . 
DELETE ALLI«~ 

WAIT. 

END DELETE .n SEC. 


400 USED< 


500 AS AN~ 
600 EXAMPLE- 


700 OF THE 

800 DELETE 

DELETE 200, 400-550, 700 TO END= 
WALT. 

END DELETE .n SEC. 

LIST~ 

PILE:TRASH - TYPE:SEQ --06/16/68 
i100 THIS 

300 BE 

600 EXAMPLE 

END LIST 1.0 SEC. 
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EXECUTE 


EXECUTE. 
The work file or an object file on disk can be executed by using 


the EXECUTE (or the DO) command. Its formats are: 
4, EXECUTE f LIBRARY u 


where f is the object file name and 


u is the user's code. The above may 


be repeated with DO instead of EXECUTE. 


The program is run from the object file associated with the fiie 
specified in the command. If authorized to do SO, a user may exe-= 
cute the object versions of files in another user's library by 
foiiowing the rite name with either a slash (/) or: the word LIBRARY 
and then the user code. i1f there is no object file, the error 


message is: 
ERR: NOFILE 
If the object file is found, the message typed by CANDE is: 
RUNNING 
When the program is finished, the message is: 
END file name n SEC, 
This indicates the processor time used to execute the job. 
Example: 


EXECUTE TEST< 
RUNNING 
END TEXT 4.6 SEC. 
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FILES 


FILES. 
The FILES command is used to obtain the names of the files in the 


user's library. Its formats are: 


1. FILES 
2. LIST PILES 


The name of all the files in the user's library are listed. The end 


of the list is indicated by a number sign (#). 


Examples: 
FILES= 
LINKS SANTA 
# 


LIST FILES 
LINKS SANTA 


il 
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FIX 


FIX. 
The FIX command is used to delete or replace a portion of a line 


t 
of input. It has the following formats: 


1. FIX sdi dn 
2. * ss dtldn 


where s is the sequence number, 
dis a delimiter, 1 is the old 
string, and n is either a new 

string or is blank. 


A FIX command causes CANDE to replace the characters specified by 
the old string with the characters in the new string. It does this 
by searching the line specified by the sequence number from left 

to right until it finds a string of characters in the line which is 
identical to the old string specified in the FIX command. It then 
discards those characters and. if a new string was included in the 
command, it inserts the characters of the new string in their place. 
Therefore, any given string of characters in a line may be deleted 


or replaced by another string. 


The delimiter is used to mark the beginning and end of the old string. 
It may be any valid non-blank character that does not appear in 

the old string. The first non-blank character after the sequence 
number is taken as the delimiter. Everything, including blanks, 
between the first two appearances of the delimiter is taken as the 

old string. Everything following its second appearance is taken as 
the new string. Neither of the strings may exceed 63 characters 

in length. If the FIX command results in a record of more than 72 


characters, the record is truncated to 72 characters. 


CANDE does not apply the change when it is entered. Instead, it 
stores the contents as a record with other data entries in the work 
file. Then, when a command which affects the work file is issued, 


such as LIST, RUN, SAVE, etc.,; all the changes that have been stored 
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FIX 


continued 


are made, and any errors in the FIX commands are noted. Thus, 
error messages are typed following the first command which uses the 
work file. Except for causing error messages to be typed, FIX 
commands in error are ignored, and processing continues as if they 


had not been entered. 


Since CANDE initially treats a FIX command as if it were a record 
in the work file, more data or another command may be entered after 
the FIX command has been terminated by a left arrow (<). Further- 
more, the FIX command may not be combined with other commands 


through the use of the semicolon, as described under COMMANDS. 


If the specified string cannot be found, the following message is 


2 iti: oi fF 


typed: 

FIX IGNORED -- SEQUENCE NUMBER sequence number 
Examples: 

MAKE X= 

FILE:xX TYPE:SEQ -- CREATED 


100 THIS TS A SAMPLE 

200 TO SHOW HOW FIX - 

300 WORKS 

"CHANGE -SAMPLE- TO -EXAMPLE-<— 
FIX 100 . S.N EX 

"REPLACE -HOW-< 

FIX 200 #HOW#THE WAY IN WHICH 
LIST 


FILE:X - TYPE:SEQ --04/29/68 
100 THIS IS AN EXAMPLE 


200 TO STHE WAY IN WHICH HOW: FIX 


END LIST 1.1 SEC, 


"OOPS- THE LETTERS -HOW- ARE A PART OF SHOW AND THE 
"FTX CHANGED THEM BECAUSE THEY CAME FIRST IN THE LINE 
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continued 


*200 $THE WAY IN WHICH$<— 
*300 .S.ING- 


PILE:X - TYPE:SEQ --04/29/68 


200 TO SHOW FIX 
300 WORKING 


END LIST .9 SEC. 


GUARD. 
The GUARD command permits the user to build or modify a guard file 
to allow other users or user's programs to read or read/write to 


a file. Its format is: 


GUARD 


CANDE starts by typing: 
NEW OR OLD GUARD FILE? 


and the user responds with the word NEW if he wishes to create a new 
guard file, or OLD if he wishes to update an existing guard file. 


CANDE then types 
GUARD FILE NAME? 


and the user types the name of the old file or the name he wants to 
use for the new file. If a current guard file is being updated, 


CANDE types: 
ADD, DELETE, LIST, SAVE, OR QUIT? 


The user then responds with his applicable choice causing CANDE to 


again type: 


ADD, DELETE, LIST, SAVE; OR QUIT? 


any order until he accomplishes everything he wants to do with the 


file. Actions are taken for each option as follows: 


a. ADD is used to add user codes and/or program names to the 


file. After ADD is typed, CANDE will respond: 


READ ONLY NAMES? 
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continued 


The user may then enter a list of user codes and/or program 
names which will be added to the file. These user codes/ 
program names will be allowed to read but not change those 
files with which this guard file is associated. Program 


names must be entered in the format 
file name/user code (of the owner of the file) 


The items in the list must be separated by commas or blanks, 
If the user does not wish to add any read-only names to the 


guard file, he should type a group mark (<). 
Next, CANDE will ask for 
READ/WRITE NAMES? 


Any user codes and/or program names entered in this case 
will be able to access and change those files with which 


this guard file is associated. 
b. DELETE causes the program to type: 
NAMES TO BE DELETED? 


The user then enters those user codes and/or program names 


he wishes to remove from the guard file. 


c. LIST produces a listing of all the user codes in the file. 
Read only names are preceded by an R in parentheses and 


read/write names are preceded by a W. 


d. SAVE must be typed to save the guard file. The file can be 
saved more than once, in which case only the version last 


Saved remains on disk. 


e. QUIT causes the program to terminate. Any additions or 
deletions made since the last SAVE will not be entered into 


the guard file. 
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GUARD 


continued 


When a new file is being created, the program first asks for READ 


only names and then for read/write names just as it does for an ADD. 


ADD, DELETE, LIST, SAVE, OR QUIT? 


and the user may use any of the options described above. 


Example: 


GUARD— 
RUNNING 


——]—] ee ee 


(w) HATTER 
ADD, DELETE, LIST, SAVE; OR QUIT? 


READ ONLY NAMES?RED, QUEEN 


READ/WRITE NAMES ?<- 


ADD, DELETE, LIST, SAVE, OR QUIT? 


OO Se eS 


DELETE" 

NAMES TO BE DELETED? 

HATTER — 

ADD, DELETE, LIST, SAVE, OR QUIT? 
SAVE 


THANK YOU, 


END GUARD 1.1 SEC. 
# 
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HELLO. 


The HELLO verb is used to initiate a log-in sequence. The format 


is: 


HELLO 


The HELLO verb causes the session of the current user to be ter- 


minated and a new session initiated without physically performing 


a terminal disconnect. 
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LIST. 
The LIST command is used to list the contents of a file. Its format 


7) 


6. LIST f LIBRARY u 
List £70 -¢ 
LIST £ LIBRARY u q 


where f is a file name, u is a user 
code, and q is a list of one or more 
elements in any combination, of the 


following two forms: 


where s; Ss and S, are sequence 


nine 
> 7 
numbers and 8. Sy 


In addition, the last element of the 
list q may be one of the following 


two forms: 


a. END 
b. s TO END 


| where s is a sequence number. | 


Without a file name, the LIST command lists the work file. With a 


file name, the specified file is listed. If a list of sequence num- 


bers is not included, the entire file is listed. Otherwise, the lines 
with the specified sequence numbers are listed. An entry of the form 
s causes that line to be listed. An entry of the form S1-S5 will 


cause a listing of all lines with sequence numbers in the range from 
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LIST 


continued 


the first sequence number through the second sequence number. The 
word END is equivalent to the highest sequence number in the file. 
A maximum of nine sequence numbers are allowed in the list. If more 


than nine are entered, the message typed is: 


ERR: TOOMANY. 


Any extra entries will be ignored. 


The sequence numbers in the list must be in ascending numerical 


sequence. If a sequence number is out of order, CANDE types: 
ERR: SEQNUM. 


Requests to list non-existent records according to sequence number 


reference are ignored. 


Examples: 


LIST 
ERR: WRKFILE 

LOAD X;LIST= 

FILE:X - TYPE:ALGOL -- LOADING 
END LOAD 1.1 SEC. 


FILE:X - TYPE:ALGOL --09/24/67 


100 BEGIN REAL X;Y3 
200 X:=¥:=53 
OO X:=X/Y; 


OO END. 


END LIST 1.1 SEC, 
LIST 50+~250, END- 


FILE:X - TYPE:ALGOL --09/24/6 
100 BEGIN REAL X,Y; 


AVY sheet eS 


200 X2-Ve=5e 
— ed 
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END LIST 1.0 SEC. 
LIST X 100, 250 TO END 


FILE:X - TYPE:ALGOL --09/24/67 
100 BEGIN REAL X,Y; 

3BOO X:=X/Y3 

400 END. 


END LIST .9 SEC. 


LIST 


continued 
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LOAD. 


The LOAD command loads an existing file as the work file. The 


format is: 


where f is 
the file name. 


If the load is successful, CANDE types: 


If, however, 


typed is: 


Examples: 


1. 


4~30 


FILE:file name TYPE:file type -- LOADING 


END LOAD 1.0 SEC. 


the file is not in the user's library, 


ERR: file name 


LOAD" 
ERR: NOFILE 
LOAD BIGFIL— 


FILE: BIGFIL - TYPE:SEQ -- LOADING 


END LOAD 1.0 SEC. 


LOAD JUNK — 

ERR: JUNK 

oe 

JUNK IS NOT IN YOUR LIBRARY 


LOAD JUNKY— 


FILE: JUNKY - TYPE: ALGOL -- LOADING 


END LOAD 1.0 SEC, 


the message 


LOCK 


ACK 
wACE Sa) 


The LOCK command restores a file to its original locked status, or 


attaches a guard file to a file. Its formats are: 


3. LOCK SOURCE f 

y, LOCK SOURCE f WITH eg 
5. LOCK OBJECT f 
6. LOCK OBJECT f WITH eg 


where f is a file name and g is a guard 
file. 


Only the owner may access his files with locked status (all files 
start off as locked). Only the programs and the users listed in the 
guard file may access the file (see GUARD to create a guard file). 


The owner may access without being in the guard file. 


Examples: 


i. LOCK SOURCE EXAMP< 
LOCK EXAMP<- 


2. LOCK SOURCE EXAMP WITH USEFLE< 
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MAKE. 
The MAKE command creates a new file and establishes it as the work 


file. The formats of the MAKE command are: 


1. MAKE f 
MAKE f t 
3. MAKE f SIZE n 


a 
4, MAKE f t SIZE n 


where f is a file name, t is a file 
type, and n is the number of lines 


to be contained in the file. 


The file type may be ALGOL, COBOL, FORTRAN, BASIC, or SEQ which can 
be abbreviated as :t, where t is the first letter of the type. For 
instance, :A would be equivalent to ALGOL. If no type is specified, 


then sequenced (SEQ) is assumed. 


A MAKE command which includes a SIZE specification may be immediately 
Followed by the SAVE verb to reserve an area of the specified size. 


The output files for BASIC programs must be reserved in this way. 


After the file has been declared with the MAKE verb, CANDE responds 
with: 


FILE:file name - TYPE:type -- CREATED 
If a file with the specified name already exists, CANDE types: 
FILE:file name - TYPE:file type -- DUPLICATE NAME 


Examples: 


1. MAKE GROOVY BASTC< 


ERR: NOF ILE 


Lege 


MAKE 


continued 


oe 


FILE NAME REQUIRED 

MAKE FAB 

Q< 

FAB ALREADY EXISTS IN YOUR LIBRARY 
MAKE FAB2 :S 
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MERGE. 
An existing file can be merged into the work file by using the MERGE 


command. It has the following formats: 


1. MERGE f 
. MERGE f q 
3. MERGE f r 


2 
4, MERGE f q r 


where f and r are defined as in the 


COPY command, yielding 48 cases. q 
is a list of one or more elements, 
in any combination, of the following 


two forms: 


where s, Sy? and S5 are sequence 


1° 


numbers and s, > s 
a zal 


In addition, the last element of the 
list q may be one of the following 


two forms: 


a. END 
b. s TO END 


where s is a sequence number. 
———— 
The specified file, or the indicated portions of it, will be merged 


into the work file according to sequence numbers. In case of dup- 
licate sequence numbers, the record in the work file maintains 


priority. A successful merge is indicated by a number sign. 


The numbers in the sequence list must be in ascending numerical 
order. END is equivalent to the last sequence number in the list, 
A maximum of nine entries are allowed in the iist. If the work file 


has not been declared, the message typed is: 


ERR: WRKF ILE 
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ts 
m4 
% 
I 
2) 
j— 
.) 


FILE:USA - TYPE:SEQ --07/04/68 
100 ONE. 

200 TWO. 

300 THREE. 


END LIST .9 SEC. 
MAKE XYZ< 

200 TWO.X< 

4OO FOUR. X= 

600 SIX.X< 

MERGE USA 
#LIST< 


FILE:XYZ - TYPE:SEQ --11/07/68 


300 THREE. 
400 FOUR.X 
600 SIX.X 


END LIST 1.0 SEC. 


MERGE 


continued 
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PRINT. 

The PRINT command is used to print a line(s) or a file. It is dif- 
ferent from the LIST command in that it suppresses the heading and 
causes CANDE to type only a number sign (#) when finished. The 


formats are: 


where f is a file name, u is a user code, 


and q is a list of one or more elements 


in any combination, of the following two 


where s, Si? and S, are sequence numbers 


> . 
and S5 Sy 


In addition, the last element of the list 


q may be one of the following two forms: 


D. s TO END 


where s is a sequence number. 
eT teen el 


3 
quence range to be printed. Only the sequence numbers specified will 


be printed. This can be from one to nine sequence numbers. 
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Examples: 


PRINT 
ERR: WRKFILE 
LOAD X;PRINT- 


FILE:X - TYPE:ALGOL -- LOADING 


Pare se nD VO eel 


END LOAD 1.1 SEC. 
100 BEGIN REAL X,Y; 
200 X:=Y¥:= 

300 X:=X/Y3 


400 END. 


PRINT 50-250, END— 
100 BEGIN REAL X,Y; 
200 X:=Y¥3= 

400 END. 


PRINT X 100, 250 TO END 
100 BEGIN REAL X,¥3 
300 X:=X/Y3 


400 END. 


PRINT 


continued 
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PUNCH. 
The PUNCH command may be used to punch the work file or a file on 
disk to paper tape. The format is: 


PUNCH f 


where f is 
the file name. 


After entering a PUNCH command, the user must turn on the paper tape 
punch. The system will then send 10 rubouts, the name of the file, 
40 rubouts, the contents of the file, and 40 more rubouts. Each line 
of data is ended with a carriage return, a line feed, a group mark, 
and a rubout. The tape can therefore be read back to the system 
using the TAPE command by initially positioning it in the first set 
of 40 rubouts. 


If the specified file is not present, the error message is: 


ERR: NOFILE 
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REMOVE. 


The REMOVE command is used to remove files from the user's library. 


REMOVE s 


where s is a list of one or more 
elements, in any combination, of 
the following three forms: 


f e e a 
SOURCE fF... 
OBJECT fF .. . 


ae 


b. 


Ce 


where f is the file name 
of the file being removed. 


If the optional words SOURCE and OBJECT are not used, both versions 
of the files named in the list are removed. The SOURCE and OBJECT 
options are included to indicate that the files following them in 
the list should have only the source or object versions removed. 
These options apply to all files following them in the list until 


another option is invoked or until the end of the list. For example, 


REMOVE FILE1, FILE2, SOURCE FILE3, FILE4, OBJECT FILE5 


would result in the removal of both versions of FILEI1 and FILE2, 
the source versions of FILE3 and FILE4, and the object version of 
FILE5. Note that all files for which both the source and object 


versions are to be removed must appear in the beginning of the list. 


If the source version is removed, a file can only be run or executed. 
A maximum of nine entries, i.e., file names and uses of the SOURCE 
and OBJECT options, are allowed in the list. If this maximum is 


exceeded, CANDE will respond with 
ERR: TOOMANY 


and will ignore the extra entries. After the REMOVE command has 
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REMOVE 


continued 


been executed, a number sign is typed to indicate that CANDE is 


ready for the next command. 


Reference to a non-existent file will be noted by the message: 


Examples: 


4-ho 


ERR:file name 


REMOVE FILE1,FILE2,FILE3¢ 
# 


"BOTH VERSIONS OF ALL THREE FILES HAVE BEEN REMOVED.< 


REMOVE FILE1,SOURCE FILE2,OBJECT FILE3+ 

it 

"BOTH VERSIONS OF FILE] HAVE BEEN REMOVED= 

"ONLY THE SOURCE VERSION OF FPILE2 HAS BEEN REMOVED 
"THE OBJECT VERSION, IF PRESENT, REMAINS ON DISK+ 
"FILE3 -SAME AS FILE2 WITH SOURCE AND OBJECT REVERSED- 
REMOVE OBJECT PILEL,FILE2,FPILE3- 

it 

"OBJECT VERSIONS OF ALL THREE FILES HAVE BEEN REMOVED- 
"SOURCE VERSIONS, IF PRESENT, REMAIN ON DISK< 


RENAME 


The RENAME command changes the name of the work file. The format 


iss 


where f is the 


new file name. 


RENAME may be used to give the work file a new name so that a sub- 
sequent SAVE will not destroy an existing file. A number sign (#) 
is used to indicate that the renaming has been performed. If there 


is no existing work file, CANDE responds with 


ERR: WRKFILE 


Example: 


LIST FILES« 
TESTX 

LOAD TESTX= 

FILE: TESTX - TYPE:BASIC -- LOADING 
END LOAD 1-0 SEC. 

RENAME TSTING< 

#LIST FILES< 

TSTING 

#300 X=Y< 

RENAME TESTER@ 

#SAVE" 

FILE:TESTER - TYPE:BASTIC -- SAVED 
LIST FILES“ 

TSTING TESTER 


Fi 


Ned 


RESEQ 


RESEQ. 


The RESEQ verb is used to change sequence numbers in the work file. 


It has the following formats: 


1. RESEQ f 
2. RESEQ f b 


oe RESEQ f S47-S5 
4, RESEQ f bi 


5. RESEQ f S,tS5ti 


where f is the file name, b is 


the base number, Sy and So are 


sequence numbers, and i is the 


If a file name is 


RESEQ will op- 


increment. 


not specified, 


erate on the work file. 


If a base number is used, the entire file will be resequenced using 
the base number as the first sequence number and increasing each 
successive number by the increment. If the base number and/or the 


increment are not given, they are assumed to be 100. 


If a pair of sequence numbers is used, the lines between the two 


sequence numbers are resequenced using the given increment. 


After the file has been resequenced, the number sign is typed. If 


resequencing results in a se 


resequencing is abandoned and the message 
ERR: TOOBIG 


is typed. This leaves the last lines of the file with incorrect 


sequence numbers. A correct RESEQ must be given before proceeding. 
Example: 


MAKE TESTO2 :F< 
FILE: TESTO2 - TYPE:FORTRAN -- CREATED 


SO 


RESEQ 


continued 


RESEQ +30— 
#LIST- 


FILE: TESTO2 - TYPE: FORTRAN --10/19/67 
100 REAL I,J 


END LIST .9 SEC. 


RESEQ 100-130 +20< 
#140 JaI**2~ 


LIst< 

FILE: TESTO2 - TYPE:FORTRAN --10/19/67 
100 REAL I,J 

120 f=T/J 


END LIST 1.0 SEC. 


443 


RUN 


RUN. 
The RUN command causes CANDE to take whatever actions are necessary 


to run the specified program. It has the following formats: 


1. RUN 


2. RUN fc 
3. RUN f/u 


4. RUN £ LIBRARY u 


where c is the compiler name or 


is biank, 


f is the file name, 


and u is the user's code. 


CANDE will run the specified file by executing the object version 
if it is available or, if there is no object version, by compiling 
and executing the source version. If a file name is not included 


in the RUN command, the work file will be run. 


If RUN f requires f to be compiled, the resulting object file is 
executed but not saved. However, if the work file is compiled with 
RUN, the object file is kept in the work file so that, if the work 
file has been changed since it was created or last saved, both 


versions can be saved. 


The compiler name can be ALGOL, COBOL, FORTRAN, BASIC or an abbre- 
viation consisting of a colon followed by the first letter of the 
compiler's name. It is required for files of type SEQ, but in any 
case, it will override the original file type and can be used for 


any file type. 


If it has been arranged through the file security system, object files 
belonging to another user can be executed by including his user code 
in the RUN command. Note that one user can only execute the object 
version of another users file. He cannot compile the source version. 
Therefore, a RUN command specifying a file in another users library 


is equivalent to an EXECUTE command specifying that file. 


ly ply 


RUN 


continued 


The messages typed by CANDE are the same as those typed for the 


COMPILE and EXECUTE commands. 


messarces 


Thus, 


COMPILING 
END COMPILE n SEC. 


The messages for execution are: 


Examples: 


RUNNING 
END file name n SEC. 


LIST EXAMP< 


FILE:EXAMP - TYPE:BASIC 


100 LET X=Y=4<- 
150 PRINT "X="xX, 
200 END 


END LIST .8 SEC. 


LOAD EXAMP< 


FILE:EXAMP - TYPE:BASTIC 


END LOAD .2 SEC. 


FIX 150."Y=",.xX*<— 
LIST< 


FILE:EXAMP - TYPE:BASIC 


100 LET X=Y=t 
150 PRINT "X="X, X*Y 
200 END 


END LIST 1.0 SEC. 
RUN EXAMP< 
RUNNING 
X=e4 


END EXAMP 
RUN 


Y=4 


SEC. 


ry = WY 


if compiling is necessary, the 


sat l 7/67 


-- LOADING 


-~-11/25/67 


(original version) 


(new version) 


WS 


RUN 


continued 


COMPILING 
END COMPILE 1 SEC. 
RUNNING 

X=4 16 


END EXAMP .4 SEC. 
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DAVE. 


The SAVE command causes a copy of the current work file to be saved 


The SAVE command does not clear the work file, but merely establishes 
a permanent disk file which reflects the work file at the time the 
SAVE was entered. Any previous copies of the file are removed. If 
the work file is saved more than once, only the version last saved 


remains on disk. 


If the work file has not been changed since it was initially created 
or last saved, the SAVE command is ignored. If the save is performed 
and there is an object version of the work file which agrees with the 
source version, both versions are saved. Otherwise, the object file 
is not saved and the disk space allocated for it is returned to the 
system. Whenever a save is done, the old versions of both the source 


and object files are removed. 


Each file is saved as a locked file unless the user has previously 
specified a different form of file security through the use of the 


GUARD, LOCK, and UNLOCK commands. 
When the file is saved, CANDE types: 

FILE:file name - TYPE:file type --SAVED 
If there is no work file, CANDE types: 


ERR: WRKFILE. 


Example: 


LOAD TESTX< 

FILE: TESTX - TYPE:ALGOL -- LOADING 
END LOAD 1.0 SEC. 

O10 COMMENT **ALGOL PROGRAM**3< 
SAVE- 

FILE:TESTX - TYPE:ALGOL -- SAVED 
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SCHEDULE. 
Jobs may be added to the schedule of jobs to be run in the back- 
ground mode by using the SCHEDULE command. The format is: 


SCHEDULE f,.f 


pieeee 


where the f's 
are file names. 


The object versions of the files named are scheduled to be run in 
background mode. This means that the job cannot send output to or 
receive input from the Teletype. A number sign is typed after 


the jobs have been scheduled. When the job has finished running, 


the message 
file name FINISHED 


is sent to the Teletype if the user is still connected to the 


system. 


If the file is not present or does not have an object version, 


the message typed is: 
ERR: NOFILE 
Example: 


SCHEDULE SDO1B, SDO1A~- 


# 


4-48 


SEQ. 
The SEQ verb is use 


en ey 


to request CANDE to type the sequence numbers 


jen 


for the user as he is inputting his file. It has the following 


where i, is a line number 


and as is an increment whose 


value is no greater than 500,000. 


The first integer gives the starting line number and the second, 
which is always preceded by a plus sign, gives the increment be- 
tween successive sequence numbers. If the increment is missing, 


100 is assumed. If the starting sequence number is missing, the 


ment is used. When automatic sequencing is used, the user must 
wait for the sequence number to be typed before entering his data. 
Automatic sequencing is terminated by typing a group mark (-) 
immediately after the sequence number. CANDE will type a number 


sign (#) to indicate that it is ready for further input. 


Example: 


MAKE XBASIC— 

FILE:XBASIC - TYPE:SEQ -- CREATED 

"QOPS-- NEED A BLANK OR COMMA BETWEEN PARAMETERS" 
MAKE X BASIC< 

FILE:X - TYPE:BASIC -- CREATED 


100 DIM x(20)< 
200 Y=3*x(2)< 


4-49 


SEQ 


continued 


300 ZxVY **¥Q< 
400 

#150 INPUT X= 
#SEQ@ 

400 T=I+1- 
500 END- 
600- 


it 
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STATUS. 
The STATUS command is used to obtain the present status of the user 
or his programs. The format is: 


1. STATUS 


2. STATUS £ 


3. ? STATUS 


where f£ is the 


file name. 


A STATUS command with a file name is used to request information 
about a job which has been scheduled. It will return either the time 
the job has been in the schedule or the processor time it has used 


running. If the file has not been scheduled, the error message is: 
ERR: file name 


If a file name is not included and the user is not running or com- 
piling a program, the STATUS command rei 
day, the time at which the user logged-in, the charge code being used 
(if any), the elapsed time since he logged in, the processor time he 


has used, and the status of any jobs he has scheduied. 


If the user has a job running, the STATUS command may be used to find 
out how long it has been running. In this case, the STATUS verb must 


be preceded by a question mark to distinguish it from data for the 


program. 
Example: 
STATUS < 
12/29/67 10342 
ON AT 10:30 
ON LINE 12 MIN 
PROCESSOR TIME 31 SEC 
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SCHEDULED ITEMS 
JOBI RUNNING 10 SECS 


# 


STATUS JOB1< | 
JOB1 SCHEDULED 6 MIN 


# ' 


RUN JOB2< 

RUNNING 

?STATUS< 

JOB2 RUNNING 28 SECS 


STOP 


STOP. 
A scheduled job may be terminated by the STOP command. The for- 


STOP 


If the program is running, it is aborted and CANDE responds 


mat is: 


file name...USER DS-ED. USED n SECS 


where n is the number of seconds used by the program before it 


was discontinued. 


If the program is not yet running, it is removed from the schedule 


and CANDE responds: 


file name REMOVED FROM SCHEDULE. 


Tf a schedule command has not been issued for that file, the 


ERR:file name 


Example: 


STOP SDO1B- 
SDOIB REMOVED FROM SCHEDULE 


TAPE 


TAPE. 
The TAPE command is used to specify that a paper tape file is to be 


read. Its formats are: 


1. TAPE 
2. TAPE SEQ 
Ky 


3 TAPE SEQ i 
TAPE SEQ +i 


1 
a = 
Os TAPE SEQ i, + i, 


where iy is a line number and 


i, is an increment whose value 


2 
is no greater than 500,000. 


The system will type an OK message and then send an X-ON character 
which initiates the tape reader if it is set to AUTO-START. If the 
reader is not set for AUTO-START, the user must manually start the 
reader after the OK message. After the tape has been read, the user 
must turn off the reader and type ?END< to terminate the tape mode, 
The system responds with a number sign to indicate that it is no 
longer in tape mode. All system output to a user in tape mode is 


suppressed between the time the X-ON and the # are sent. 


When the SEQ option is not used, the data is treated the same way as 
ordinary input. Each line must have a sequence number, but the lines 
may be out of order. Corrections, in the form of FIX commands or 
retyped lines, may be included on the tape. When SEQ is used, the 
first line is given a sequence number equal to the base, and the 
sequence number for each succeeding line is increased by the incre- 
ment. In the latter case, the lines must be in order and they 


cannot contain sequence numbers or FIX commands. 


A work file must be specified by the use of LOAD or MAKE verb before 


th 7 A 


he TAPE command may be typed. 1f this sequence is not followed, the 


system will type: 


ERR: WRKF TLE 


4-5 


TAPE 


continued 


MAKE WORK COBOL“ 

FILE:WORK TYPE:COBOL -~ CREATED 
TAPE 

OK 

?END“ 

# 
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TO. 
The TO command is used to send a message to other dialed-in users or 


to the computer operator at the central site. The formats are: 


1. TO SPO m 
2. TO ALL m 

[ 3. Toum 
4, TO i, m 


where m is the message, 


u is a user code, and 


i, is a logical line 


number. SS can also be 


used in place of TO. 


Depending upon whether SPO, ALL, a user code, ora logical line 
number is used in the command, the message will be typed at the 
operator's console, at the terminals of all the users logged on, at 
the terminals of any users logged on with the specified user code, 
or at the terminal connected to the specified line. SPO is a mnemo- 
nic for supervisory printer, the name given to the operator's con- 


sole. In all cases, the message is typed in the following format: 
FROM sender's user code (sender's logical line number ) message 


Example: 
TO SPO I NEED A SCRATCH TAPE 


If there are no users connected with the given user code, or if the 


specitied line is not logged in, CANDE will respond with either 


user code NOT ON 


or 


logical line number NOT ON 
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TO 


continued 


ing user is in operation, such as running a program, 


CANDE will type to the sending user: 
user code BUSY 


In either case, CANDE will discard the message. 
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TYPE 


TYPE. 


The TYPE command is used to change the file type associated with 


the work file. 


where t is 
the file type. 


The file type options are ALGOL, COBOL, FORTRAN, BASIC; and SEQ 
which may Be abbreviated with the first letter of the type pre- 


ceded by a colon. 


If a work file has not been assigned to the user, the following 


error message is given: 


ERR: WRKFILE 


uw 


ae 4 . foun a aig ga 
CANDE responds with a number sign \F) after the file type has 


Bp 
been changed. 


Example: 
LOAD IRS= 
FILE:TRS - TYPE:SEQ -- LOADING 


END LOAD 1.0 SEC. 
TYPE BASIC:LIST— 


i 


FILE:IRS - TYPE:BASIC --04/15/68 
100 X=4 

200 PRINT X**Y 

300 END 


bar 
CO 
op) 
& 
( 


END LIS‘ 
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UNLOCK. 


UNLOCK 


The UNLOCK command allows any user to access a file - for read/only 
(if SOURCE), or execute/only (if OBJECT). The owner may access in 


any manner. The formats are: 


1. UNLOCK f 
2. UNLOCK SOURCE f 


3. UNLOCK OBJECT f 
where f is a file name. 


UNLOCK SOURCE EXAMP< 
UNLOCK EXAMP=- 


Example: 
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WHATS. 
The WHATS command returns the name and type of a file and, for a file 


saved on disk, the number of records it contained. Its formats are: 


where f is a file name. 


If the file name is not included or is included and is the work file 


only, the answer returned is: 


FILE: file-name TYPE: type --- WRKFILE 


If the file name is included and is that of a file saved on disk, the 


answer returned is: 
FILE: file-name TYPE: type --- CONTAINS integer RECORDS 


Examples: 


WHATS XYZ-- (assuming XYZ to have been SAVEd) 
FILE:XYZ TYPE:COBOL --- CONTAINS 56 RECORDS 


WHATS 
FILE:XYZ TYPE:COBOL --- WRKFILE 
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system. They 


the blank low 


Blank 


— * CF RP Nm 


are arranged by columns in collating sequence with 


APPENDIX A 
CHARACTER SET 


and the ? high: 


Hem Sev ak Se 


NM DO ve oO 4 Br RY 


—~«M«e ed GH 


wu FP ON 


y oO @O™N DW Ut FW 


Three other characters are acceptable to the system as control char- 


acters only. 


the deiete (i 


They are the group mark (<), the backspace ('), and 


X 


ye 


APPENDIX B 
RESERVED WORDS 


The following is a list of all words used in the Command and Edit 


language. 


be used as file names. 


A 

ADD 
*ALGOL 

ALL 

APPEND 

B 
*BASIC 

BYE 

Cc 

CHANGE 

CHARGE 


*COBOL 
COMPILE 
COPY 
CREATE 
D 
DELETE 
DO 

*END 
EXECUTE 
F 

*FILES 


FIX 

* FROM 
FORTRAN 
GUARD 
HELLO 
LIBRARY 
LIST 
LOAD 
LOCK 
MAKE 
MERGE 


* OBJECT 


PASSWORD 
PRINT 
PRINTER 
PUNCH 
REMOVE 
RENAME 
RESEQ 
RUN 


Words preceded by an asterisk are reserved and may not 


SCHEDULE 
*SEQ 
SIZE 

* SOURCE 
STATUS 
STOP 
TAPE 
*TO 
*TYPE 
UNLOCK 
WHATS 


APPENDIX C 
THE FILE SECURITY SYSTEM 


The B 5500 Time Sharing System uses the file security system developed 
for the Data Communications MCP. This system recognizes one privileg- 
ed user who is allowed access to all files in the system. On the 

Time Sharing System he is defined to be the installation running the 


computer. 


All other users are subject to the constraints of the file security 


system. For them, there are three levels of file security: 


a. <A locked file may be accessed only by the person who created 
it. This type of security is created by the use of the 
SAVE command. All files start as locked files. 


b. <A guarded file may be accessed by the users and programs 
listed in*the guard file associated with the file. A guard- 
ed file can be created by the use of the GUARD and the LOCK 


commands. 


c. An unlocked file can be read (or executed, if the fiie has 
an object version) by anyone, but it can only be changed by 
the person who created it. Unlocked files are created by 


the use of the UNLOCK command. 


The security status of a file is treated in much the same way as the 
file name or the file type. In effect, the security status is loaded 
with the file and, if not changed by the user, remains with it when 


the file is saved, even if the file name has been changed. 


A guard file can specify two levels of access for either programs or 


users? 
a. Read only - the program or user may only read the file (or 
execute if object code). 
b. Read/write - the program or user may read from or write into 


the file (not allowed on object code). 


APPENDIX D 
COMMAND AND EDIT SYNTAX 


(APPEND file-name user-code | sequence-list | 
jADD LIBRARY pee ! 
BYE 

( PASSWORD TO File-name 
CHANGE TYPE TO type 


ie 
CHARGE charge-code 


COMPILE [file-name]| [compiler | 


( file-name TO hardware-unit 
COPY \ ] : : 
) file-name LIBRARY user-code [ sequence-list | 
( range r : 
| Rese pees | L+ increment 
DELETE [ALL] : 
sequence-list | 
J EXECUTE | file-name user-code 
DO LIBRARY 
FIX Stee ae 
" sequence-number delimiter oid-string 
delimiter [new-string] 
GUARD 
HELLO 


PRINT| rsne-nane | | user-coae| | [ sequence-list | 


LIBRARY | 


APPENDIX D (cont) 


ado Ree nee 1 
[ LIST ]FILES | jfile type a 


LOAD file-name 


SOURCE (_ ; 
perk | OBJECT | file-name [ WITH guard-file-name | 
MAKE : 
CREATE( file-name [type] [SIZE integer] 


MERGE file-name 


LIBRARY 
[reste ee | [+ increment] 
\souRCcE 
REMOVE bee | file-name-1, [file-name-2]... 
I (source 


OBJECT 


7 
(| file-name-3, [file-name-4]... 


Ll 


RENAME file-name 


base 
range 


RESEQ [file-name] | | [+ increment ] 


([compiter] 


RUN [file-name ] y. ] 
[ LIBRARY user-code 


SAVE 
SCHEDULE file-name-1 [, file-name-2]... 


SEQ [base] [+ increment ] 


user coae [sequence-list ] 


5 


APPENDIX D (cont) 


ALU 


1e) | 
) sTAaTUS ( 


(spatus T¢ 


STOP 


rr 71 
TAPE | SEQ [base] [+ increment ] | 


SPO 
Ze nae message 
Ss user code . & 
line number 
TYPE type 
SOURCE P 
UNLOC f - 
NLOCK | OBJECT | ile-name 


WHATS [file-name | 
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